            /******************************************************************/
            //VIA VNT6655 Linux driver Software Package Internal Release Note//
            /******************************************************************/

Updated:2009-11-18
=================
   Current driver version: v1.20.02
   
Support OS
==========
   FC serial:
    1. Fedora core 2
    2. Fedora core 3
    3. Fedora core 4
    4. Fedora core 5
    5. Fedora core 6
    6. Fedora core 7
    7. Fedora core 8
    8. Fedora core 9
    9. Fedora core 10
   Ubuntu serial:
    1. Ubuntu 6.06
    2. Ubuntu 7.04
    3. Ubuntu 7.10
    4. Ubuntu 8.04
    5. Ubuntu 8.10
6. Ubuntu 9.04
7. Ubuntu 9.10
   Debian serial:
    1. Debian 3.0
    2. Debian 4.0
   SUSE serial:
    1.suse 10.1
    2.suse 10.3
    3.sled 11
   Xandros serial:
    1.Xandros 4.2

Function support:
=================
    1. Support 802.11 a/b/g station functions
    2. Support wireless extension interface (WE-17 or UP version)
    3. Support supplicant(STA) wpa/wpa2 with wpa_supplicant-0.5.8 
  Notice: 
    We strongly recommend that don't use iwconfig and Network-manager to configure WLAN at the same time.
    
Subdirectory description inside this package
============================================
    internalreleasenote.doc                    This file.
    attach_detach                              routine for attach and detach function 
                                               in Non-NetworkManager OS,such as FC4,5,etc...
    LICENSE                                    For open source note.
    remove                                     Remove driver module shell script.
    Makefile                                   Makefile for install driver & utility.
    /driver/*.c, *.h.Makefile                  Makefile and VNT USB driver(vntwusb) source code.
    /wpa_supplicant/wpa_supplicant-0.5.8       The package of wpa_supplicant for 'vntwusb' driver.
    /include/*.h                               The driver and utility include files.
    /utility.zip                               The source code of utility.
    
Installation Guide
==================
     Please enter the following commands at the UNIX prompt. Remember, UNIX is
     case sensitive and make sure your root login.
     1. Compile the source files and it will generate './driver/viawget.ko'.The file 'viawget.ko' 
        will copy to driver installation path.
          make clean
          make install
     2. Check configuration file (/etc/modules.conf or /etc/conf.modules or /etc/modules.conf,it 
        depend on your Linux distribution) for loading kernel modules. Make sure there is the following 
        content in the configuration file, where # is interface number (eg: alias eth0 vntwusb):
          alias eth# vntwusb

     3. Install your driver module (If the driver module is in the wrong place, an error message will 
        appear, and say that can't find the driver module):
          insmod viawget.ko
     4. use iwconfig command to check your wireless device interface number
         iwconfig 
     5. Use ifconfig command to assign the IP address up device, where # is network 
        interface number:
         ifconfig eth# up <Ipaddress>
     6. Use iwconfig to setup wireless connection,where xxxx is desired ssid name:
        if authentication type is open and encryption is none:
         iwconfig eth# key off
         iwconfig eth# essid xxxx
        if authentication type is shared and encryption is wep key:
         iwconfig eth# key <key index> <passphrase> restricted
         iwconfig eth# essid xxxx 
        for more iwconfig user manual,please refer to "man iwconfig".
     7. Check if the interface works:
         ping <remote_host_IP>
     8. Disabled WLAN & remove module:
         ifconfig eth# up
         rmmod viawget.ko
         
Notice: How to change Zone Type as USA or Europe
================================================
     User need copy target object code to desired OS folder and file of /driver/vntconfiguration.dat 
     need to be copied to the folder :/etc/.
     prefer to run in USA, please change ZONETYPE=USA in /etc/vntconfiguration.dat ,
     prefer to run in EUROPE, please change ZONETYPE=EUROPE in /etc/vntconfiguration.dat .
     
Compile code appearance issues
===============================
     1.	when you execute command: make clean 
        Error: Makefile:23: *** Linux kernel source not found
        Solution: Download the kernel source and essential compilation tools
                  sudo apt-get install build-essential linux-headers-`uname -r`
                  ln -s /usr/src/linux-headers-`uname -r` /lib/modules/`uname -r`/source
     2.	when you compile openssl, if can't find perl appearing, please execute below command:
                  cp /usr/bin/perl /usr/local/bin
     3. when you compile wpa_supplicant, can't find crypto.a appearing, please copy libcrypto.a 
        under openssl folder to /usr/lib:
                  cp libcrypto.a /usr/lib

     For SuSE Linux 10.1 / OpenSuSE 10.3: It will pop "main_usb.o error" message
                  log in os  as root;
                  entry the folder:/lib/modules/2.6.22.5-31-default,
                  and type: 
                     1 ./lib/modules/2.6.22.5-31-default /rm -rf  build ;
                     2. :/lib/modules/2.6.22.5-31-default /ln -s /usr/src/linux-2.6.22.5-31 ./build  
                     3.  /usr/src/linux-2.6.22.5-31/make menuconfig
                     Exit;
                     Save;
                     /usr/src/linux-2.6.22.5-31/make

Known Issues
============

Release History
===============


 1. 2006-1030-01,<Add> by NomadZhao
    <Solution>: All the files are from VT6655_V117 released by Taipei.
    <Files>   : CodeChangeIndex

 2. 2006-1116-01,<Add> by NomadZhao
    2006-1116-01,<Modify> by NomadZhao
    <Problem> : Shared WEP align bug,6655 acts as AP and in Shared WEP mode, station can't to associate to 6655 and can't ping OK, this bug found in V1.16 & V1.17.
    <Solution>: Add '#pragma pack()' to adjust fields within structure to correct address alignment; or exchange the location of fields within structure.
    <Files>   : bssdb.h iocmd.h iowpa.h key.h

 3. 2006-1123-02,<Modify> by EinsnLiu
   <Problem> : When setting WEP key strings,the key index not match with the expected.
   <Solution>: Correct the issue sentence.
   <Files> :driver/ioctl.c

4.2007-0118-03,<Add> by EinsnLiu
  <Problem> : After VT6655 running as AP with WPA encryption mode,set WEP share key encryption directly.Stations can't connect the AP successly.
  <Solution>:1.when exit the WPA,should reset 2 key control variables:pMgmt->byCSSCPK,pMgmt->byCSSGK,if not,all stations can't connect the AP because of "WEP Function Failed".
             2.when exit the WPA,should reset the VT6655's Key Tables,if not,the station who connected the AP success when AP in WPA mode can't connect it now, but others station can.Because VT6655 use the hardware Key Table to decripte the frames coming from the station whose MAC address matched with the Key Table have.So VT6655 AP can't receive the encryption frames frome the stations whose MAC address stroed in the Key Table. 
   <Files> :driver/hostap.c
   
5.2007-0207-04,<Add> by EinsnLiu
  <Problem> : Using iwconfig channel/freq command to set the frequence cann't go into effect at once.
  <Solution>: Add a sentence "pDevice->bCommit = TRUE;",it indicated the setting need to run extra things to go into effect. 
  <Files> :driver/iwctl.c
  
6.2007-0207-05,<Mark> by EinsnLiu
  <Problem> : Using command "iwconfig" to get the wireless interface information,when in AP mode,it always return the Max rate. 
  <Solution>: Mark the unnecessary sentences. 
  <Files> :driver/iwctl.c
  
7.2007-0207-06,<Add> by EinsnLiu
  2007-0118-06,<Modify> by EinsnLiu
  <Problem> : Using command "iwconfig" to get the wireless interface information,encryption item sometimes can't be shown or show error.
  <Solution>: Can't say it in short.See the modification of the file.
  <Files> :driver/iwctl.c

8.2007-0207-07,<Modify> by EinsnLiu
  <Problem> : There are many problems when using iwconfig encode/key command to set the WEP key.
  <Solution>: Can't say it in short.See the modification of the file.I almost rewrite the function "iwctl_siwencode".
  <Files> :driver/iwctl.c

VT6655_v118:
9.2008-4-8 by chester
<problem> using iwconfig config essid can't link
<solution>	             #if WIRELESS_EXT < 21
 DEVICE_PRT(MSG_LEVEL_INFO, KERN_INFO " SIOCSIWESSID1 \n");
		pItemSSID->len = wrq->length - 1;
	     #else
 DEVICE_PRT(MSG_LEVEL_INFO, KERN_INFO " SIOCSIWESSID2 \n");
		pItemSSID->len = wrq->length;
<files> iwctl.c

10.2008-0410, <Modify> by Einsn Liu
	<problem> get bssid bug when in station mode, if the station is not connect,should return zero BSSID
	<solution>  
	<files> iwctl.c

11.2008-0409 <add> by chester	
<problem> modify led issue
<solution> add "MACvRegBitsOff(pDevice->PortOffset, MAC_REG_GPIOCTL0, LED_ACTSET);" in function CARDbRadioPowerOn & CARDbRadioPowerOff in card.c;
add in mac.h as follows:
// Bits in the MAC_REG_GPIOCTL0 register
//
#define LED_ACTSET           0x01        //
#define LED_RFOFF            0x02        //
#define LED_NOCONNECT        0x04        // 

12.2008-4-14 <modify> by chester
//2008-4-14 <add> by chester for led issue
//2008-4-14 <mark> by chester for led issue
in bssdb.c&device_main.c.
if need LED function then define the macro FOR_LED_ON_NOTEBOOK in device.h,otherwise mark it.

13.2008-4-14 <porting> by chester
support networkmanager
14.2008-4-23 <porting> by chester
support fast-roaming

15.//2008-5-8 <add> by chester
the bit rate that iwconfig show follow the actual bit rate adjust

16.//2008-5-13 <add> by chester
add for cover <2.6.16 and >2.6.16

17.// 2008-05-21 <mark> by Richardtai&&// 2008-05-21 <add> by Richardtai
modify for RSSI display issue

18.mark all spin_lock in function wpa_set_keys() in wpactl.c because hang up issue on xandros OS

19.in wpa_set_associate in wpactl.c:
    if (memcmp(param->u.wpa_associate.bssid, &abyNullAddr[0], 6) != 0)	
        memcpy(pMgmt->abyDesireBSSID, param->u.wpa_associate.bssid, 6);
else
{
   bScheduleCommand((HANDLE) pDevice, WLAN_CMD_BSSID_SCAN, pItemSSID->abySSID);
}//add

in vMgrDecodeProbeResponse()in 802.11mgr.c:
		/*
        if (pItem->byElementID < byCheckEID)
            break;
        else
            byCheckEID = pItem->byElementID;        
*///mark

20.2008-7-10:
  add zone type setting fucntion by script file of change driver code directly.

1.19.04:  
21.//20080717-06,<Modify> by chester
fix open mode and WEP encrytion for wpa supplicant.
file:wpactl.c

22://2008-0714-01<Add>by Mikeliu
add function that remove virtual device WPADEV safely before device is closed.
file:/driver/main_usb.c,wpa_supplicant/wpa_supplicant-0.5.8/driver_viawget.c

23:change parameter definition from "wpa_set_keys(PSDevice pDevice, struct viawget_wpa_param *param, BOOL  fcpfkernel)" 
   to "wpa_set_keys(PSDevice pDevice, void *ctx, BOOL  fcpfkernel)",it can fix compile issue in lower kernel version.
 file:/driver/wpactl.c 
 
 24.merge modification by Shirley Hu
 25.add virtual device for wpa_supplicant when device open 
 maybe can fix the issue that meet abnormality when release from wpa_supplicant

VT6655-v119-06:

26.//2008-8-4 <add> by chester
fix the scan channel according zonetype issue in card.c&wcmd.c in ver 1.19.05
27.//2008-8-4 <add> by chester
fix channel for the right zonetype confuse,for instance,client associate with 13 channel by mistake if 
current zone type is USA(1~11).
file:/driver/wmgr.c 
28.add zonetype change function by user through file(/etc/vntconfiguration.dat). 
 if eeprom version is lower than2.0 and USA--->Europe,than fill channel 12,13 by channel 11.
 file:driver/device_main.c
29.fix signal level show issue when use iwconfig.
file:function iwctl_get_wireless_stats in /driver/iwctl.c

VT6655-v119-07:
//2008-8-21 chester
30.add the modification of Shirley
31.fix the issue that send null packetfrequently,now send null packet every 40s while driver do nothing

32.VT6655-v119-08:
//2008-09-02  <mark>	by chester
don't turn off RF while disassociation

33.VT6655-v119-09:
modify the announcement at the top in all the .c&.h files

34.VT6655-v119-10:
change driver release copyright from Proprietary to GPL

35.VT6655-v119-11:
a.fix serious packet loss in wpa2psk mode.The reason is that the driver 
  initialize to power save mode and sends null packets while sends data 
  packets,which lead to low throughput.
b.fix the issue that can't ping in open wep mode
c.fix the issue that system hang using networkmanager in FC9
d.fix the issue that can't link using networkmanager in wep mode

36.VT6655-v119-12:
a.fixed the issue that can't link AP with hidden SSID 
b.solve compile issue in ubuntu8.10(2.6.27) in file of iwctl.c;
c.solve hidden ssid mode issue in network-manager,
d.add timer_expire in wmgr.h, to make the timer expire no need to wait timeout when associate.

37.VT6655-v119-13:
quicken association with AP using networkmanager.

38.VT6655-v119-14:
modify to support 2.6.29.3
39.VT6655-v119-15:
change TX data rate by monitoring the RSSI value.
40.VT6655-v119-16:
add antenna diversity function
41.VT6655-v120-01:
a.modify antenna diversity function at unlink mode
b.modify s3s4 function
42.VT6655-v120-02:
a:fix Ad-hoc mode connection issue when using Network-manager;
b:fix WPA1/TKIP&AES or WPA2/TKIP&AES Mixed mode connect fail issue;
c:sync pMgmt->abyDesireSSID with pMgmt->abyDesireBSSID in BSSpSearchBSSList
  for roaming mode;
d:compatible 2.6.31;
e:add antenna diversity function at initialize stage.  

